.TH RXQUEUE 1 "April 2021" "Version 5.0.0"
.SH NAME
\fBrxqueue\fP \- Open Object Rexx Queue Filter
.SH SYNTAX
.B rxqueue
.RI [ queuename "] [/fifo | /lifo | /clear]"
.SH DESCRIPTION
This program operates as a filter, placing the output of an operating system command onto an
external ooRexx queue.

.PP
The name of the queue to act upon is determined in the following order:

.TP
1.
.IR queuename " specified on the command line"
.TP
2.
The name of the queue specified by the environment variable
.B RXQUEUE
.TP
3.
The default queue name
.B SESSION

.SH OPTIONS
.TP
.B /fifo
places lines onto the queue in first-in first out order. This is the default.
.TP
.B /lifo
places lines onto the queue in last-in first out order.
.TP
.B /clear
removes all lines from the queue.

.SH "SEE ALSO"
.BR rxsubcom (1)

.SH EXAMPLES
.TP
ls | rxqueue MYQ /lifo
Places output from the
.B ls
command onto the
.B MYQ
queue in last-in first-out order.
.B MYQ
must have been created before it can be used.

.TP
export RXQUEUE=MYQ; rxqueue /clear
Clears the contents of
.B MYQ.
.B MYQ
must have been created before it can be used.

.SH LICENSE
Open Object Rexx is distributed under the terms of
the Common Public License v1.0 which accompanies this distribution.
https://www.oorexx.org/license.html

This program and the accompanying materials are made available under
the terms of the Common Public License v1.0 which accompanies this
distribution. A copy is also available at the following address:
https://www.oorexx.org/license.html
